home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / nestgt.zip / NESTGET.DOC < prev    next >
Encoding:
Text File  |  1993-01-04  |  5.8 KB  |  172 lines
  1. *  Documentation for Enhancements Inc. Single Line Nested Read functions
  2. *  Copyright (c) 1990 Enhancements Inc.
  3. *
  4. *      Single Line Nested Read Functions including:
  5. *           Nestgetn(),
  6. *           Nestgetc(),
  7. *           Nestgetd() and
  8. *           Nestgetl()
  9. *      are herein after referred to as  Product.
  10. *
  11. *
  12. *       By using our Product you agree to the following terms:
  13. *
  14. *
  15. *  You do not own or have a license to use Product in any way until you
  16. *  pay Enhancements Inc. for Product. The price is Nineteen dollars
  17. *  ($19.00) US. Once you pay for this product you become a purchaser of
  18. *  it and the following conditions apply.
  19. *
  20. *  We grant the you the purchaser a non transferable license to use our
  21. *  product as much as you want and to distribute applications developed
  22. *  using it without royalties. You are allowed to copy this product for
  23. *  your own use and backup and you may distribute product as long as this
  24. *  file is included.
  25. *
  26. *
  27. *  Once registered we will send you any update information, such as
  28. *  these functions for Clipper 5.0. We will also send you information on
  29. *  our other products, with the hope that we can sell them to you! 
  30. *
  31. *  If you have a copy of our Product that you did not purchase, call us!
  32. *  We will be glad to sell you your own copy with, update information
  33. *  and tech support. At only $19.00 a clear conscious is cheap!
  34. *
  35. *  If, on the other hand, you choose to steal our work we hope others are
  36. *  already stealing yours ( they are probably still paying too much!). If 
  37. *  we find out you are using our product to develop applications we will 
  38. *  hunt you down and force you to program in dBaseII using Edlin on a single
  39. *  floppy, 4.77mhz base PC until Clipper Mid-Spring 1999 is released and 
  40. *  debugged!
  41.  
  42.  
  43. Single Line Nested Reads:
  44.  
  45. These functions for CLIPPER SUMMER87 allow you to perform a read using
  46. a Clipper variable while within another Clipper READ statement. We will 
  47. not attempt to explain the use of nested reads as a concept here, beyond
  48. the information needed to use these functions. If they need more instruction
  49. or information, registered users can call for more detailed help. Our
  50. goal is to make a product that is simple to use and small on memory
  51. requirements. With the later in mind we do not perform a great deal of
  52. error checking. Pass a number where a number is called for or a date
  53. when that is the function you are using. Also use an appropriate PICTURE
  54. template and valid screen coordinates. For memorys' sake we do not 
  55. directly effect the contents of the Clipper variable that you are reading
  56. into but rather return the modified value for you to asign to it as shown.
  57.  
  58. The syntax for all the commands is as follows:
  59.  
  60. *********
  61. Numeric
  62.  
  63. <numeric var> = NESTGETN( <row>, <col>, <numeric var>, <numeric template> )
  64.  
  65.   EXAMPLE:
  66.  
  67.     Num_var = 5
  68.     Num_var = NESTGETN( 1, 5, Num_Var, "999999.99" )
  69.                         │  │     │          │
  70.                   Row  ─┘  │     │          └───── Picture template
  71.                   Column ──┘     │           
  72.                                  └───── Clipper varible name or 
  73.                                         array element of proper
  74.                                         type.
  75.                                               
  76. *********
  77. Character
  78.  
  79. <char var> = NESTGETC( <row>, <col>, <char var>, <char template> )
  80.  
  81.   EXAMPLE:
  82.        
  83.     Char_var = "Yo"
  84.     Char_var = NESTGETC( 2, 5, Char_var, "XXXX" )
  85.  
  86.  
  87. *********
  88. Date
  89.  
  90. <date var> = NESTGETD( <row>, <col>, <date var>, <date template> )
  91.  
  92.   EXAMPLE:
  93.  
  94.     Date_var = CTOD("02/02/90")
  95.     Date_var = NESTGETD( 1, 5, Date_var, "99/99/99" )
  96.  
  97.  
  98. *********
  99. Logical
  100.  
  101. <logical var> = NESTGETL( <row>, <col>, <logical var>, <logical template> )
  102.  
  103.   EXAMPLE:
  104.  
  105.     Logic_var = .T.
  106.     Logic_var = NESTGETD( 1, 5, Logic_var, "T" )
  107.  
  108.  
  109.  
  110. The basic idea here is to be able to do a READ from within another
  111. READ for example in a VALID function.
  112.  
  113.  
  114.  
  115.  
  116. *****************************************************************
  117. OTHER PRODUCTS FROM ENHANCEMENTS INC.:
  118.  
  119.   WE ALSO HAVE THE FOLLOWING PRODUCTS AVAILABLE:   
  120. *****************************************************************
  121.   
  122.   NESTED READS
  123.   
  124.     A complete Nested Reads function library. This is the fastest most
  125.     complete true nested reads library around. Written in C and Assembler
  126.     these functions are small and fast. They include error checking and
  127.     full help facilities. Also the ability to use CLIPPER input validation.  
  128.     No better input functions available at any price. The others just don't
  129.     get it!
  130.     Written in C and assembler.
  131.    
  132.   SINGLE LINE NESTED READS
  133.   
  134.     If you do not need multiple gets on many levels these functions will
  135.     allow you to input a single value of any type from within a CLIPPER
  136.     READ. 
  137.     Written in C and assembler 
  138.  
  139.  
  140.   CHANGE COLORS!
  141.   
  142.     A function for CLIPPER that will allow you to dynamically change the
  143.     color attributes anywhere on the screen at any time. Change one letter,
  144.     a line (horizontal or vertical) or any area up to the whole screen.
  145.     Includes all video modes support and blinking. It can be used to change
  146.     the color of any previously displayed text anywhere on the screen, with
  147.     one function call. 
  148.     This routine also available for Basic, Pascal, Fortran, C, Turbo C,
  149.     Turbo Pascal and Dos command line.
  150.     Written entirely in assembler.
  151.  
  152.  
  153.   SHADOWS
  154.   
  155.      A function for CLIPPER that puts true shadows around your window
  156.      boxes. Allows you to chose colors or change the location of the
  157.      shadow to any of the eight possible locations around the box.
  158.      Written entirely in assembler for speed and size.
  159.  
  160.  
  161. Send money and registration to:
  162.  
  163. ENHANCEMENTS INC.
  164. P.O. BOX 7009 SUITE 213
  165. LAFAYETTE, CA  94549
  166.  
  167. Donald & Gregg
  168. (415) 932-7815
  169. Compuserve 72331,1001
  170. 3/16/90
  171.  
  172.